home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus 2000 #4 / Amiga Plus CD - 2000 - No. 4.iso / Vollversion / CamD / development / examples / capture / capture.doc < prev    next >
Text File  |  2000-05-15  |  3KB  |  62 lines
  1.  
  2.                                  MIDI Capture
  3.                                    By Talin
  4.  
  5.     MIDI Capture is a little utility that uses camd.library to capture all
  6. incoming MIDI data and store it in an internal memory buffer using the
  7. Standard MIDI File format. Once the data is captured, it can be sent out again,
  8. or saved to a file. You can also load any Standard Midi File into the memory
  9. buffer as well.
  10.     Each incoming messages is appended to the internal buffer, which expands
  11. and contracts dynamically as needed. (In the current version, there is no way
  12. to turn off this capturing feature). The window displays the number of bytes in
  13. the buffer.
  14.     Note that Capture ignores all timing information. Incoming data is
  15. timestamped with a time of zero, and timestamps of Standard MIDI files which
  16. have been loaded in is ignored. When sending, all the data is sent at once.
  17.     The main purpose for this utility is to capture System Exclusive messages
  18. such as patch dumps, audio samples, tuning maps, and other device data, and
  19. store them on disk.
  20.  
  21. Gadgets
  22. ~~~~~~~
  23.     The "Load..." button loads a standard MIDI file. The current contents of
  24. the buffer is discarded before the new data is read in.
  25.     The "Save..." button saves the current contents of the buffer to a Standard
  26. MIDI file. The buffer is not affected by this operation.
  27.     The "Send" button sends the contents of the buffer out via MIDI.
  28.     The "Clear" button empties the buffer. There is no confirmation prompt.
  29.  
  30. Menus
  31. ~~~~~
  32.     The Clear, Load, and Save menu items operate exactly like their gadget
  33. counterparts.
  34.     The Quit menu item quits the program.
  35.     The About menu item shows the program information.
  36.     The "Set Input Link..." and "Set Output Link..." menu items allow you to
  37. redirect where the MIDI input is coming from, and where it will be sent to. A
  38. scrolling list of MIDI cluster names will be presented, along with a string
  39. gadget where a custom name, one not in the list, can be typed.
  40.  
  41. Notes
  42. ~~~~~
  43.     Capture has no support for editing the data in the buffer, or
  44. re-channelizing on output. It is assumed that another CAMD utility could be
  45. created for this purpose.
  46.  
  47.     Standard MIDI Files often contain "Meta-Events" which are special message
  48. events such as text strings, clef changes, etc. These cannot be transmitted
  49. over MIDI, and are ignored during a send. However, loading a standard MIDI file
  50. and saving it back out again will preserve these events (The Capture utility
  51. just loads the file raw into memory and writes it back out again). In addition,
  52. all timing information is preserved, even though Capture ignores it.
  53.  
  54. Possible Future Enhancements
  55. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  56.     A checked menu item to disable the capturing of new messages.
  57.     A checked menu item to support realtime.library for using the time stamp
  58. information. (Although, I don't want to have to deal with issues like Tempo and
  59. such, that's really the job of a true sequencer. Perhaps I would only enable
  60. this for MIDI files which have actual rather than metric timing).
  61.     The ability to load "raw" midi dumps (i.e. not standard MIDI files).
  62.